Skip to content

doc: nrf-bm: libraries: timer: updates to BM timer documentation#459

Merged
eivindj-nordic merged 1 commit into
nrfconnect:mainfrom
eivindj-nordic:doc_bm_timer_update
Nov 18, 2025
Merged

doc: nrf-bm: libraries: timer: updates to BM timer documentation#459
eivindj-nordic merged 1 commit into
nrfconnect:mainfrom
eivindj-nordic:doc_bm_timer_update

Conversation

@eivindj-nordic
Copy link
Copy Markdown
Contributor

Updates to BM timer documentation.

@eivindj-nordic eivindj-nordic self-assigned this Nov 6, 2025
@eivindj-nordic eivindj-nordic requested review from a team as code owners November 6, 2025 13:05
@github-actions github-actions Bot added changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. doc-required PR must not be merged without tech writer approval. labels Nov 6, 2025
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Nov 6, 2025

You can find the documentation preview for this PR here.

Comment thread doc/nrf-bm/libraries/timer.rst Outdated

Timer library
#############
BM Timer library
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks a bit ugly in my opinion. I would follow the wording used in the bm_zms library and such and write instead the following:

Suggested change
BM Timer library
Bare Metal Timer library

At the bare minimum we need to align everything to the same style, one way or the other.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to Bare Metal

Comment thread doc/nrf-bm/libraries/timer.rst Outdated
:depth: 2

The timer library allows the application to create multiple timer instances.
The BM Timer is a library that is wrapped on top of the Zephyr Timers functionality that is implemented using the GRTC peripheral.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The BM Timer is a library that is wrapped on top of the Zephyr Timers functionality that is implemented using the GRTC peripheral.
The Bare Metal (BM) Timer library provides a wrapper around Zephyr's Timers functionality, utilizing the GRTC peripheral.

Comment thread doc/nrf-bm/libraries/timer.rst Outdated
The BM Timer is a library that is wrapped on top of the Zephyr Timers functionality that is implemented using the GRTC peripheral.

Functions such as starting and stopping timers, checking for timeouts, and invoking user-defined timeout handlers are all managed within the GRTC interrupt handler.
The BM Timer has a resolution of 1 µs and is able to run in all power modes.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The BM Timer has a resolution of 1 µs and is able to run in all power modes.
The BM Timer has a resolution of 1 µs and can run in all power modes.

Comment thread doc/nrf-bm/libraries/timer.rst Outdated

Functions such as starting and stopping timers, checking for timeouts, and invoking user-defined timeout handlers are all managed within the GRTC interrupt handler.
The BM Timer has a resolution of 1 µs and is able to run in all power modes.
This gives the capability of waking up the system after a period or at specific intervals, independent of power modes.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This gives the capability of waking up the system after a period or at specific intervals, independent of power modes.
This allows for waking up the system after a specific period or at specific intervals, independent of power modes.

Comment thread doc/nrf-bm/libraries/timer.rst Outdated
Functions such as starting and stopping timers, checking for timeouts, and invoking user-defined timeout handlers are all managed within the GRTC interrupt handler.
The BM Timer has a resolution of 1 µs and is able to run in all power modes.
This gives the capability of waking up the system after a period or at specific intervals, independent of power modes.
The BM timer allows the application to create multiple timer instances each with dedicated user defined timeout handlers.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The BM timer allows the application to create multiple timer instances each with dedicated user defined timeout handlers.
The BM Timer allows the application to create multiple timer instances, each with dedicated, user defined timeout handlers.

Updates to BM timer documentation.

Signed-off-by: Eivind Jølsgard <eivind.jolsgard@nordicsemi.no>
@eivindj-nordic eivindj-nordic merged commit d79f0a5 into nrfconnect:main Nov 18, 2025
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. doc-required PR must not be merged without tech writer approval.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants